home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / gfxapps / ifse100 / imgfun.txt < prev    next >
Text File  |  1992-12-11  |  43KB  |  1,026 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 I M G F U N . T X T
  10.  
  11.                                   C O N T E N T S
  12.  
  13.  
  14.  
  15.           1.  Introduction. . . . . . . . . . . . . . . . . . . . . . .1
  16.  
  17.               1.1  ImgFun Package . . . . . . . . . . . . . . . . 1
  18.               1.2  Packing lists. . . . . . . . . . . . . . . . . 1
  19.  
  20.           2.  ASP Ombudsman . . . . . . . . . . . . . . . . . . . . . .2
  21.  
  22.  
  23.           3.  System Requirement. . . . . . . . . . . . . . . . . . . .3
  24.  
  25.               3.1  Display mode . . . . . . . . . . . . . . . . . 3
  26.               3.2  VESA support . . . . . . . . . . . . . . . . . 3
  27.               3.3  SVGA support . . . . . . . . . . . . . . . . . 4
  28.  
  29.           4.  Computer Images . . . . . . . . . . . . . . . . . . . . .6
  30.  
  31.               4.1  Gray Level Images. . . . . . . . . . . . . . . 6
  32.               4.2  Color Mapped Images. . . . . . . . . . . . . . 6
  33.               4.3  True Color Images. . . . . . . . . . . . . . . 7
  34.  
  35.           5.  What's ImgFun for?. . . . . . . . . . . . . . . . . . . .8
  36.  
  37.               5.1  ImgFun under Windows and PaintBrush. . . . . . 8
  38.  
  39.           6.  General Operations. . . . . . . . . . . . . . . . . . . 10
  40.  
  41.               6.1  How to start ImgFun. . . . . . . . . . . . . .10
  42.               6.2  Main menu functions. . . . . . . . . . . . . .10
  43.               6.3  The on line help system. . . . . . . . . . . .11
  44.               6.4  Fast Start . . . . . . . . . . . . . . . . . .11
  45.  
  46.           7.  Image Formats . . . . . . . . . . . . . . . . . . . . . 13
  47.  
  48.               7.1  GIF. . . . . . . . . . . . . . . . . . . . . .13
  49.               7.2  PCX. . . . . . . . . . . . . . . . . . . . . .13
  50.               7.3  BMP. . . . . . . . . . . . . . . . . . . . . .13
  51.               7.4  JPEG  (*.jpg)  Compression and Decompression .14
  52.               7.5  Other Formats. . . . . . . . . . . . . . . . .16
  53.  
  54.           8.  Function Usage: . . . . . . . . . . . . . . . . . . . . 17
  55.  
  56.               8.1  File:. . . . . . . . . . . . . . . . . . . . .17
  57.                    8.1.1  Load: Load an image to work. . . . . . 17
  58.                    8.1.2  View: View an image file.. . . . . . . 17
  59.                    8.1.3  Save: Save the loaded image 1. . . . . 17
  60.                    8.1.4  Quit: Quit ImgFun. . . . . . . . . . . 17
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.               8.2  Adjust:. . . . . . . . . . . . . . . . . . . .17
  68.                    8.2.1  Brighten: Brighten the loaded image. . 17
  69.                    8.2.2  Darken  : Darken the loaded image. . . 17
  70.                    8.2.3  Contrast:. . . . . . . . . . . . . . . 17
  71.                    8.2.4  cOlor   :. . . . . . . . . . . . . . . 17
  72.               8.3  Set: . . . . . . . . . . . . . . . . . . . . .17
  73.                    8.3.1  Background: Choose a background color. 17
  74.                    8.3.2  Cut area  :. . . . . . . . . . . . . . 17
  75.                    8.3.3  Directions:. . . . . . . . . . . . . . 17
  76.                    8.3.4  Threshold : View a binary map. . . . . 17
  77.               8.4  Transform: . . . . . . . . . . . . . . . . . .17
  78.                    8.4.1  Rescale   :. . . . . . . . . . . . . . 17
  79.                    8.4.2  Smooth:. . . . . . . . . . . . . . . . 18
  80.                    8.4.3  shArpen: . . . . . . . . . . . . . . . 18
  81.                    8.4.4  rOtate:. . . . . . . . . . . . . . . . 18
  82.               8.5  Options: . . . . . . . . . . . . . . . . . . .18
  83.                    8.5.1  Display  : . . . . . . . . . . . . . . 18
  84.                    8.5.2  card     : . . . . . . . . . . . . . . 18
  85.                    8.5.3  direcTory: . . . . . . . . . . . . . . 18
  86.                    8.5.4  Dither   : . . . . . . . . . . . . . . 18
  87.               8.6  Utility: . . . . . . . . . . . . . . . . . . .18
  88.                    8.6.1  Compress  : JPEG compression . . . . . 18
  89.                    8.6.2  cOnvert   :. . . . . . . . . . . . . . 18
  90.                    8.6.3  sLide show: a manual slide show. . . . 18
  91.               8.7  Undo and Update: . . . . . . . . . . . . . . .18
  92.               8.8  Swap (F3) :. . . . . . . . . . . . . . . . . .19
  93.               8.9  DOS  (F6) :Shell out to DOS. . . . . . . . . .19
  94.               8.10  Gray (F7) : . . . . . . . . . . . . . . . . .19
  95.  
  96.  
  97.  
  98. ImgFun.txt               Speedy Software                   page 1
  99.  
  100.  
  101.  
  102.  
  103.                                   1.  Introduction
  104.  
  105.       1.1  ImgFun Package
  106.  
  107.           ImgFun is  a   powerful  image compression   and  enhancement
  108.       program for  computer  images.   ImgFun is  designed to let   you
  109.       regain the tremendous amount of disk space occupied by   GIF like
  110.       images  in  your    system  and explore the  pleasure of  viewing
  111.       images in the awesome 256-color SVGA modes.
  112.  
  113.           ImgFun is  developed  by Speedy  Software    and  distributed
  114.       as shareware.   For   shareware  and  registration,   please read
  115.       register.txt.  Once  again,  for   supporting  affordable quality
  116.       software, PLEASE  REGISTER!!!
  117.  
  118.       1.2  Packing lists
  119.  
  120.       IFSE100.exe  :  A   self  extracting file  made   by  the  Lha213
  121.       package which  is   copyrighted  by  Haruyasu  Yoshizaka contains
  122.       the following files:
  123.  
  124.  
  125.         readme.txt         A short compilation of important information
  126.         ImgFun.exe         The program itself
  127.         ImgFun.hlp         The help file
  128.         ImgFun.pif         PIF for Windows
  129.         ImgFun.txt         This file
  130.         register.txt       Registration and development information
  131.         order.frm          an easy order form to register
  132.  
  133.           If you are missing  one or more  of these files,  contact the
  134.       author  at  one  of  the  addresses  listed at  the  end  of this
  135.       document.
  136.  
  137.           For  installation,  just   copy   all  files   to   a  proper
  138.       directory of your hard disk.
  139.  
  140.           Please  do  read   register.txt,    it   contains   important
  141.       information about the future development and planning of ImgFun.
  142.  
  143.           Some  utilities  might be included  from Speedy Software.
  144.  
  145.  
  146.  
  147.  
  148. ImgFun.txt               Speedy Software                   page 2
  149.  
  150.  
  151.  
  152.  
  153.                                  2.  ASP Ombudsman
  154.  
  155.           This program  is  produced  by a  member  of the  Association
  156.       of Shareware Professionals  (ASP).   ASP  wants to make sure that
  157.       the  shareware  principle  works for you.  If you are unable   to
  158.       resolve  a  shareware-related   problem  with  an  ASP member  by
  159.       contacting the member directly, ASP  may be able  to  help.   The
  160.       ASP  Ombudsman can help you  resolve a dispute  or  problem  with
  161.       an   ASP  member,  but  does  not  provide  technical support for
  162.       members' products.   Please write  to the  ASP  Ombudsman at  545
  163.       Grover Road, Muskegon, MI 49442 or send   a   Compuserve  message
  164.       via  easyplex  to ASP  Ombudsman 70007,3536
  165.  
  166.  
  167.  
  168.  
  169. ImgFun.txt               Speedy Software                   page 3
  170.  
  171.  
  172.  
  173.  
  174.                                3.  System Requirement
  175.  
  176.           A  lot efforts   have been made  to make ImgFun   as lean and
  177.       fast as possible.
  178.  
  179.        [1]  286  or better PC  with DOS 2.0  or above
  180.        [2]  300 to 450K   of free memory  under DOS,  no   extended  or
  181.             expanded memory needed. Some of the memory  is  dynamically
  182.             allocated.  For the viewer, you need at least 300K.
  183.        [3]  VGA or  SVGA display  system. See  "SVGA  support" for SVGA
  184.             support list.
  185.        [4]  Hard  disk  space for loading and  processing  images.  One
  186.             mega bytes  or  above  free  space  is required. If you use
  187.             ImgFun as a viewer only, no hard disk is required.
  188.  
  189.           For the bulkiness of image data  and the tremendous computing
  190.       load for   processing images, a  386,  or 486  computer  with   2
  191.       mega bytes  of  free   disk   space is recommended.  ImgFun  uses
  192.       disk files  for loading images  up   to  1024   by   1024, thus a
  193.       disk cache like the smartdrv  in DOS 5.0  or Windows  3.0  &  3.1
  194.       will help ImgFun a lot and is strongly recommended.
  195.  
  196.  
  197.       3.1  Display mode
  198.  
  199.  
  200.           ImgFun    uses   256-color     mode    in    the    following
  201.       resolutions for displaying images:
  202.  
  203.        0. 300 x 200    standard VGA mode
  204.        1. 640 x 400    SVGA  available for most cards with 256 KBytes
  205.        2. 640 x 480    SVGA needs 512 KBytes on board
  206.        3. 800 x 600    SVGA needs 512 KBytes on board
  207.        4.1024 x 768    SVGA needs 1024 KBytes on board
  208.  
  209.  
  210.       3.2  VESA support
  211.  
  212.           ImgFun      also    supports   VESA    (Video     Electronics
  213.       Standards  Association) drivers  with  64K  window size  starting
  214.       at address A000h.
  215.  
  216.           In the auto-detection  mode,ImgFun  will try    to   identify
  217.       your  VGA card and determine   the  SVGA  modes  available.  When
  218.       your VGA card can not be identified,  ImgFun  will   try  to test
  219.       if a valid  VESA driver  is present, if  so the VESA  driver will
  220.       be  used.    If  no valid  SVGA chip and  VESA  driver available,
  221.       ImgFun  will   use the standard   320x200   mode  for  displaying
  222.       images.
  223.  
  224.  
  225.  
  226.  
  227. ImgFun.txt               Speedy Software                   page 4
  228.  
  229.  
  230.       WARNING:  NOT ALL VESA DRIVERS ARE SUPPORTED. YOU  HAVE  TO  TEST
  231.       YOUR VESA CARD FIRST!!!!
  232.  
  233.           VESA drivers are usually  in one  of the  VGA  utility  disks
  234.       which are  included in most VGA card packages or built in the VGA
  235.       cards.   Please consult your VGA card manual for  installation of
  236.       the  VESA  driver.   Notice  that  not  all  VESA  drivers    are
  237.       accepted  by ImgFun.  Only those detected and verified  by ImgFun
  238.       will be used.
  239.  
  240.       3.3  SVGA support
  241.  
  242.       The following SVGA chips are under support in ImgFun:
  243.  
  244.       The highest resolution available is listed.
  245.  
  246.       [1] Trident Series: Everex VGA
  247.  
  248.             8800: up to 640 x 480
  249.             8900, 9000 or newer: up to 1024 x 768
  250.  
  251.       [2] Tseng's Lab:
  252.  
  253.             ET3000: up to 800 x 600
  254.             ET4000: up to 1024 x 768
  255.  
  256.       [3] Paradise cards or Western Digitals chip sets:
  257.  
  258.             WD90C00, WD90C10: up to 640 x 480
  259.             WD90C11, WD90C30 or newer: up to 800 x 600
  260.  
  261.       [4] ATI Technologies:
  262.  
  263.             18800, 28800 or newer : up to 800 x 600
  264.  
  265.       [5] Video 7, Headlands Technology:
  266.  
  267.             V7VGA series: up to 800 x 600
  268.  
  269.  
  270.       [6] Chips and Technologies: Boca VGA
  271.  
  272.             82c451: 640 x 400
  273.             82c452: up to 640 x 480
  274.             82c453: up to 800 x 600
  275.  
  276.       [7] Genoa Systems:
  277.  
  278.             up to 800 x 600
  279.  
  280.           A new change  has been  made in version 1.0. A  -s switch  is
  281.       added  for the  standard 320x200x256  VGA  mode. A  new function,
  282.  
  283.  
  284.  
  285. ImgFun.txt               Speedy Software                   page 5
  286.  
  287.  
  288.       card,   is added to  the Options menu. Now  users can choose auto
  289.       detection or manual setting of the display driver.
  290.  
  291.           Usually   VGA   chip    manufactures    maintain     backward
  292.       compatibility with    their older  chips  when   delivering   new
  293.       VGA  chips.  In most  cases,  your VGA card from  the  above chip
  294.       vendors will  be recognized by ImgFun.
  295.  
  296.           If  problems  are  encountered  for  the  SVGA modes,  please
  297.       contact the author.
  298.  
  299.  
  300.  
  301.  
  302. ImgFun.txt               Speedy Software                   page 6
  303.  
  304.  
  305.  
  306.  
  307.                                 4.  Computer Images
  308.  
  309.  
  310.           ImgFun  operates  on   computer    images,    so   first    a
  311.       short  explanation of  what computer  images are  and  how ImgFun
  312.       works with these images.
  313.  
  314.           For  our purposes,   an image is  a data  set  that describes
  315.       the reflectance of a 2- dimensional surface such as a photograph.
  316.       In particular, an  image  is a 2- dimensional array of  "pixels",
  317.       each of  which  contains data for  the small rectangular  area of
  318.       the  image it represents. Thus a  pixel  in an image w wide by  h
  319.       height is  addressed   by 2-dimensional  coordinate (x,y)  for  x
  320.       ranges from 0 to w-1  and  y ranges from 0 to h-1. Usually  the X
  321.       direction is left to right  and the Y direction is top down. This
  322.       is  the native  format of  ImgFun.   Formats  storing  images  in
  323.       other  directions  will  be  converted  into  this practice.  The
  324.       value  of  each pixel  is interpreted  differently  depending  on
  325.       the type of the  computer  image.   There  are  three  classes of
  326.       computer images as follows:
  327.  
  328.  
  329.       4.1  Gray Level Images
  330.  
  331.           Gray  level  images    represent  images   by  storing    the
  332.       intensity of light  for each pixel on a  scale usually more  than
  333.       just on/off.  Typically, a gray  level image will allow 64 to 256
  334.       shades of gray  at  each pixel.  Very high quality  renderings of
  335.       black  and   white photographs can be  stored  in  this  way.  In
  336.       ImgFun,   gray levels of  images    range  from   0  to 255  with
  337.       0=Black  and  255=White.  Some  times  the  gray  level might  be
  338.       referred  as  the luminance( better to remember 255 is white). No
  339.       color information is stored in the gray level images.
  340.  
  341.       4.2  Color Mapped Images
  342.  
  343.           From  color theory, any  color can be  derived from  mixtures
  344.       of 3  principle  colors  with  proper  proportions. Usually, red,
  345.       green and blue  are  used  as  the  three  principle   colors  in
  346.       personal computers. Each principle component requires 5 to 8 bits
  347.       for most computer images.
  348.  
  349.           Color   mapped   images   are  the   ones   most  common   on
  350.       personal computers.  Each pixel  in  an image is  represented  by
  351.       a  number  (called  an  index) that  is   used  to  look  up  the
  352.       pixel's actual colors in a  table  (called  the  palette).  These
  353.       images  are  popular because  they can be very colorful, yet take
  354.       up  less memory than full-color images (described next).
  355.  
  356.           The  size of  the  color  palette varies  among  formats, but
  357.  
  358.  
  359.  
  360. ImgFun.txt               Speedy Software                   page 7
  361.  
  362.  
  363.       is typically 16 to 256. These are the major type of images ImgFun
  364.       is designed   to  work with. In   concept, you can  treat  a gray
  365.       level image    as  a   color  mapped  image  with  a  pre-defined
  366.       palette  such that all  the   entries  have equal values  in red,
  367.       green and blue components from 0 to 255.
  368.  
  369.  
  370.       4.3  True Color Images
  371.  
  372.           True color images are the highest quality representation, and
  373.       the largest files as well.    Each pixel  contains  the  complete
  374.       color information  for  that  pixel,  usually  expressed  as  the
  375.       intensity of the  red,  green,  and blue  color components of the
  376.       light  at that location.  For  24 bit rgb  images, each pixel  is
  377.       represented  by  one  byte  in   red,  green  and blue  component
  378.       respectively. Some images  use  5 bit per principle to  result in
  379.       a pixel  represented    by  2 bytes(  16   bit)   or   so  called
  380.       32768-color  images. These 16 bit images are emerging   in the PC
  381.       world from  support  of  new display cards  available.  The extra
  382.       bit in 16 bit images can be used  for other purposes like cut and
  383.       paste.
  384.  
  385.  
  386.  
  387.  
  388. ImgFun.txt               Speedy Software                   page 8
  389.  
  390.  
  391.  
  392.  
  393.                                5.  What's ImgFun for?
  394.  
  395.           ImgFun deals  with  gray and color mapped images in Ver. 1.00
  396.       and the next major  update version will   deal  with  true  color
  397.       images directly.  ImgFun does the following jobs for users:
  398.  
  399.       [1] display:
  400.  
  401.           Let  user   view images. Show  loaded  images   with  instant
  402.       zooming  and scrolling. Reverse   and   mirror images  instantly.
  403.       Also a manual slide show is implemented.
  404.  
  405.       [2] enhancement:
  406.  
  407.           Alter colors of images. Process images for visual pleasure.
  408.  
  409.       [3]  format  conversion:
  410.  
  411.           Convert  between  any  two formats supported.
  412.  
  413.       [4]  compression:
  414.  
  415.           Compress   color   mapped   images       and    gray    level
  416.       images  by  JPEG    compression.    Images   are  reduced   to  a
  417.       fraction   of the  original  size  for       reducing the   heavy
  418.       burden of keeping a large archive of image files.
  419.  
  420.  
  421.       5.1  ImgFun under Windows and PaintBrush
  422.  
  423.  
  424.           You can  run ImgFun  under MicroSoft  Windows  3.0  or   3.1.
  425.       But please   use  the FULL   SCREEN  MODE ONLY and  press Alt-Tab
  426.       to switch  from ImgFun to Windows.  In Windows, you can click the
  427.       icon of ImgFun to switch from Windows to ImgFun.
  428.  
  429.           DON'T  RUN  IMGFUN  IN  A  WINDOW  UNDER  WINDOWS. This might
  430.       produce unpredictable  results  if other Windows application  and
  431.       ImgFun contend for the video memory.
  432.  
  433.           If you  are using Windows  3.1, there's a  built in print out
  434.       function in   PaintBrush, which can   be located in the accessory
  435.       group. PaintBrush accepts PCX and BMP formats. Both are supported
  436.       by  ImgFun. To  import  images to   PaintBrush, you just  save or
  437.       convert images into PCX, or BMP  images and use the open function
  438.       in PaintBrush to load images.  In PaintBrush, you can  also write
  439.       texts  on the  image  with various   fonts  and do  cut and paste
  440.       of images.
  441.  
  442.           The  print  out  quality  of  PaintBrush   is   quite   good,
  443.  
  444.  
  445.  
  446. ImgFun.txt               Speedy Software                   page 9
  447.  
  448.  
  449.       especially  on  laser  printers.  A  print out module   is  under
  450.       development  in Speedy  Software.  This   print   out module will
  451.       let users  choose different algorithms  for printing images,  and
  452.       the  current module will  be  available as  a  bundled bonus  for
  453.       registered users.
  454.  
  455.  
  456.  
  457.  
  458.  
  459. ImgFun.txt               Speedy Software                   page 10
  460.  
  461.  
  462.  
  463.  
  464.                                6.  General Operations
  465.  
  466.       6.1  How to start ImgFun
  467.  
  468.           Type "ImgFun" or "ImgFun -s", under the system  command  line
  469.       with ImgFun.exe  in  the current  directory to  start  ImgFun, or
  470.       use ImgFun.PIF  to start  ImgFun under  Windows.   Then you  will
  471.       enter the  main menu  in the  menu mode. A  pull  down  menu (the
  472.       main menu), a  status  box  and a function  key bar are displayed
  473.       in the menu mode.   Type   in  the  capitalized  letters or   use
  474.       arrow keys   for  selecting functions  in  the   main menu.    An
  475.       on  line   help   system   is implemented for easy use,  also   a
  476.       good source   of    information.   The  auto-detection   mode  is
  477.       default  and   backward   compatible    with   previous      test
  478.       versions.   If you   have problems   in starting   ImgFun by  the
  479.       auto-detection function,    even   after  you installed   a  VESA
  480.       driver,   then  you should start ImgFun with the standard mode by
  481.       "ImgFun -s" in the  command line.  Now  the  standard  mode  will
  482.       use   the  320x200x256  VGA   mode  only,  unless the user    has
  483.       changed    the     display  driver    by  the function   Options,
  484.       Display, card.
  485.  
  486.       WARNING:ONLY USE MANUAL SETTING WHEN THE AUTO  DETECTION FUNCTION
  487.       FAILS  AND YOU ARE SURE YOU HAVE A VGA CARD WITH A  NEWER CHIP OF
  488.       SOME  VGA CHIP  VENDOR  LISTED.  THE  DISPLAY  CARD  FUNCTION  IS
  489.       PROVIDED  FOR THOSE NEW  CHIPS  FROM  LISTED  VGA  CHIP  VENDORS.
  490.       USUALLY  NEW  CHIPS  FROM  THE  SAME  VENDOR  MAINTAIN   BACKWARD
  491.       COMPATIBILITY IN THE MODE SETTING AND PAGING MECHANISM WITH OLDER
  492.       CHIPS, BUT MIGHT NOT BE PROPERLY IDENTIFIED BY IMGFUN.
  493.  
  494.  
  495.       6.2  Main menu functions
  496.  
  497.        File       :  View,  Load, Save,  Quit
  498.        Adjust     :  Brighten,  Darken,  cOntrast,  Color
  499.        Set        :  Background,   Cut   area, Directions, Threshold
  500.        Transform  :  Rescale, Smooth, shArpen, rOtate
  501.        Options    :  Display, direcTory, dIther
  502.        Utility    :  Compress, cOvert, sLide show
  503.  
  504.       Function keys:
  505.  
  506.       F1:HELP, F2:UNDO, F3:SWAP, F4:UPDATE,  F5:SHOW,  F6:DOS,  F7:GRAY
  507.  
  508.           And    function     key     F10      is   used     to    show
  509.       registration information.
  510.  
  511.           Some   of   the functions might require selections from lists
  512.       or input parameters to  do the  job. For the  list selection, you
  513.       can  use Up,  Down, Page  Up  and Page  Down to  scroll  for  the
  514.  
  515.  
  516.  
  517. ImgFun.txt               Speedy Software                   page 11
  518.  
  519.  
  520.       item  or  type  in   the name of  the  item,  as  you type in the
  521.       letters, ImgFun will  try  to match  the  closest item  for  fast
  522.       access.
  523.  
  524.  
  525.           For input dialogues, you  can always  use  ESC   to abort and
  526.       F1 for help.
  527.  
  528.           During the  operation of  ImgFun,  if something   went wrong,
  529.       ImgFun   will  report  error     messages.  Simply  follow    the
  530.       instructions  to continue to work. The   most  common  errors are
  531.       not enough   memory  or  disk  space, and an invalid image format
  532.       encountered.
  533.  
  534.       6.3  The on line help system
  535.  
  536.           For the help system  (activated by pressing F1  in  the  menu
  537.       mode), you can  use   Page  Up  and Page Down  to  scroll, Esc to
  538.       abort and Space bar for the topic selection list.
  539.  
  540.       6.4  Fast Start
  541.  
  542.           ImgFun    works  on   images  stored   in  some   pre-defined
  543.       formats. An image  format specifies   how  information  is stored
  544.       for   the image  and  eases   the  job of   exchanging images  in
  545.       different  applications.   ImgFun    supports    several  formats
  546.       which   will  be  explained in   the  next  section.  Files  with
  547.       corresponding format extensions   will  be   treated   as  images
  548.       saved in  corresponding formats.
  549.  
  550.  
  551.           For viewing images, use  the   File, View function.  A manual
  552.       slide show can   be performed by  storing image file  names  ( do
  553.       specify full   paths  for ImgFun to locate image files) in a text
  554.       file  by one file name a line from  the  beginning  of each line.
  555.       Simply    use  the  Utility  ,sLide  show  for  your  slide  show
  556.       entertainment.
  557.  
  558.           A   more   powerful  viewing  program  for  the  pleasure  of
  559.       seeing computer images  is provided for loaded images. To load an
  560.       image, please  use  the  File,  Load function. Up  to  two images
  561.       can   be loaded at a  time. Information about  the loaded image 1
  562.       and  loaded  image 2  is   reflected  in the  status  box. Loaded
  563.       files will  be stored  on the current directory. After  ImgFun is
  564.       started  only the  help  file ImgFun.hlp  is  needed.   You  must
  565.       specify the  help file directory in Options,  direcTory, Help  to
  566.       use the help system,  if ImgFun  is  started    in   a  different
  567.       directory  other  than the  directory   which ImgFun.hlp resides.
  568.       If  you use  a  ram disk  to start  ImgFun, make sure   you  have
  569.       enough  space  for  loading big files.  A  disk caching   program
  570.       is  strongly   recommended   for  fast   response.  According  to
  571.       experience,  a   ram  drive    will  be  redundant   ,   if   the
  572.  
  573.  
  574.  
  575. ImgFun.txt               Speedy Software                   page 12
  576.  
  577.  
  578.       smartdrv  from  Windows  3.1   is  loaded.  Smartdrv does a  very
  579.       good job in disk caching when working with ImgFun.
  580.  
  581.           After  an  image  is  loaded,  you  can use the Show function
  582.       by pressing F5. In the show mode, the loaded image 1 is displayed
  583.       in  the screen  by 256-color  VGA,  or SVGA modes.  Press Page Up
  584.       and Page  Down for  instant  zooming up  to   four times in width
  585.       and height.   Use the  arrow keys to scroll and  the '+'  and '-'
  586.       keys to increase  or decrease the  scroll step   size.  A  lot of
  587.       tricks can be played  in the Adjust  and  Set  functions.  You'll
  588.       get  instant  response by  trying these functions.    A built  in
  589.       undo and update mechanism  let you experiment on the loaded image
  590.       1.
  591.  
  592.           One  VERY  VERY   IMPORTANT  thing   to   remember  is   that
  593.       before  switching  the  display mode by  Options,  Display,  mode
  594.       MAKE  SURE  YOUR  MONITOR  CAN STAND THE HIGH RESOLUTION MODE you
  595.       want  to try, OTHERWISE   YOU  MIGHT  BURN YOUR  MONITOR'S  TUBE,
  596.       ESPECIALLY   THE KILLER MODE OF MONITORS, 1024x768.
  597.  
  598.          If  problems  are encountered  for  some  SVGA  modes,  please
  599.       contact the  author for technical  support.  I have tried my best
  600.       to include as  many  drivers  as I  could for the wild supper VGA
  601.       cards.
  602.  
  603.           A  set of  functions that might  need some  patience  to wait
  604.       is  grouped  in  the    Transform   menu.  These  functions  will
  605.       produce another image file from the loaded image 1.
  606.  
  607.           For   image   compression   and   format   conversions,   try
  608.       Utility, Compress and cOnvert functions.
  609.  
  610.           Tremendous  efforts are spent  to  make   the compression and
  611.       decompression  as  fast  as  possible  by  not  eating  too  much
  612.       precious memory under DOS.
  613.  
  614.           The compression  is    designed   for   continuous tone color
  615.       mapped images  and  gray  level  images. Color mapped images with
  616.       fewer than 32  colors and gray level  images with fewer  than  16
  617.       colors will not be accepted by ImgFun for compression.  Just save
  618.       or convert these  images  in    the   GIF   format   which should
  619.       yields  good compression results for these images.
  620.  
  621.           For the compression level required by JPEG  compression,  try
  622.       3 to 10 for color mapped images and higher for gray level images.
  623.       The best  result might need some experiments depending  upon your
  624.       eyes and the image contents.
  625.  
  626.  
  627.  
  628.  
  629.  
  630. ImgFun.txt               Speedy Software                   page 13
  631.  
  632.  
  633.  
  634.  
  635.                                  7.  Image Formats
  636.  
  637.       ImgFun Ver. 1.00 supports the following formats:
  638.  
  639.       7.1  GIF
  640.  
  641.           This  is   CompuServe's  Graphical  Interchange  Format.  GIF
  642.       images are  widely  used  in   networks like CompuServe and local
  643.       BBSes. GIF format  stores color mapped images using 12  bit   LZW
  644.       compression.  In   the world of personal  computers, color mapped
  645.       systems still  dominate. GIF offers good  compression for storing
  646.       color  mapped images and is supported by a  lot software vendors.
  647.  
  648.            There are 2 versions of GIF images, 87a and 89a.
  649.            89a is a backward compatible extension of 87a.
  650.  
  651.           ImgFun reads  in  both    versions  but  ignores  features in
  652.       89a.  For multiple  images in a  single GIF file,  only the first
  653.       image is retrieved. ImgFun always writes out GIF images in 87a.
  654.  
  655.           GIF format is recommended for storing images frequently used,
  656.       for example  in a slide  show  and images waiting for processing.
  657.       Since the coding and decoding are fairly fast.
  658.  
  659.       7.2  PCX
  660.  
  661.           This is ZSoft's Paint Brush's native  format. PCX is probably
  662.       the  first     image    format    gained   wide    support   from
  663.       different applications.  PCX uses  8 bit run  length  encode  for
  664.       storing gray and color mapped images. The latest version supports
  665.       24  bit true color images.
  666.  
  667.           ImgFun   reads   in  PCX   images with  palette  information.
  668.       Images  stored in the  latest   true color  format  will  not  be
  669.       accepted  by ImgFun.
  670.  
  671.           ImgFun  always writes PCX  images  with palette  information.
  672.       The next major  upgrade version  of ImgFun will support   24  bit
  673.       true color images in PCX format.
  674.  
  675.           PCX   format  is   recommended   for  images  requiring  fast
  676.       access, since   the   decoding  and   coding  are  blindly  fast.
  677.       But  the compression  is in general inferior to the GIF format.
  678.  
  679.       7.3  BMP
  680.  
  681.         BMP  is  the  device   independent   bit    map   format   from
  682.       MicroSoft.
  683.  
  684.           BMP  can store gray,  color mapped and true color images. For
  685.  
  686.  
  687.  
  688. ImgFun.txt               Speedy Software                   page 14
  689.  
  690.  
  691.       the popularity of   MS  Windows  3.0   and 3.1, BMP  is  becoming
  692.       another standard format in PC applications.
  693.  
  694.           Old  BMP files  before  Windows  3.0    are  not  accepted by
  695.       ImgFun.  As mentioned before,  true color  images   are   left in
  696.       the  next major upgrade version.
  697.  
  698.           ImgFun reads  and  writes BMP  images in  uncompressed  form,
  699.       since  BMP format is  designed to be  loaded as fast  as possible
  700.       under Windows.
  701.  
  702.           BMP   format  is  recommended  for  wall  papers  in  Windows
  703.       and exchanges   for Windows programs. No  compression is used for
  704.       the BMP   format.  Thus you   can  use the  BMP  format   as  the
  705.       comparison basis for  compression mechanisms used  by other image
  706.       formats.
  707.  
  708.  
  709.       7.4  JPEG  (*.jpg)  Compression and Decompression
  710.  
  711.           JPEG  stands for  Joint Photo Experts   Group.   JPEG  is  an
  712.       image  compression mechanism by  8 by 8 DCT transform coding  and
  713.       entropy coding.
  714.  
  715.           JPEG  is  designed  to  offer   varied  level  compression of
  716.       continuous tone true color and gray level images by throwing away
  717.       information barely noticeable  by    the   human   visual system.
  718.       There  are  several stages  involved in  the  JPEG mechanism. For
  719.       users  not  interested   in  the  technical   stuff can skip  the
  720.       following  materials and go     to the end  of this section.
  721.  
  722.           First, the  true color image  is converted into  the  Y,   U,
  723.       V space.  The Y component  represents the   luminance, i.e.,  the
  724.       gray level of the image.  U,V components store  information about
  725.       the chrominance,  i.e.,  the   colors.   For the    human  visual
  726.       system, the luminance is  more  important  than  the chrominance.
  727.       Thus  the U,   V   components are  sub-sampled  for reducing  the
  728.       amount of data.  Usually,   only half  samples in  the horizontal
  729.       direction  and  half  lines   in   the   vertical  direction  are
  730.       retained.  This reduces the U, and also the V components to  only
  731.       a quarter of the Y components.  Comparing  with  RGB  data,  only
  732.       half  amount  of storage is required  for  this  sub-sampling  in
  733.       YUV space.  For gray  level   images,  the value  of  each  pixel
  734.       is    just   the luminance,   i.e., the   Y component    of   the
  735.       pixel.  Thus  no compression  is obtained in  this stage for gray
  736.       level images.
  737.  
  738.           ImgFun  converts color mapped images  into true  color images
  739.       internally, then converts  true   color images into  the Y, U,  V
  740.       sub-sampled space.  The  palette information is  tagged   in  the
  741.       header of a JPEG compressed image for decoding.
  742.  
  743.  
  744.  
  745.  
  746. ImgFun.txt               Speedy Software                   page 15
  747.  
  748.  
  749.           In the next stage,  the data is divided into blocks such that
  750.       each  block  contains 8 pixel by 8 pixel  in Y,U and V components
  751.       respectively. Last blocks in  each row  and column are padded, if
  752.       necessary,  to form 8 by 8 blocks.
  753.  
  754.           Each  block is fed  into an  8 by 8  two dimensional discrete
  755.       cosine  transform to  obtain  64  coefficients representing   the
  756.       block.  Then   the  coefficients  are quantized   by   predefined
  757.       tables.   Different  tables  are used  for   the   luminance  and
  758.       chrominance   components.  After quantization,  information about
  759.       the block is  packed   in   the lower  frequency coefficients.  A
  760.       lot  coefficients  will become  zero   and all coefficients   are
  761.       represented by   integers.  By adjusting the quantization tables,
  762.       we can gain  various results. This   is where the information  is
  763.       thrown away.
  764.  
  765.  
  766.           Then an  efficient  run  length  coding  of zero coefficients
  767.       and  varied   length  coding  of   non-zero    coefficients    by
  768.       Huffman coding (or arithmetic coding which is   not  supported in
  769.       ImgFun) are applied to yield a shrink down result.
  770.  
  771.           The  decoding process reverses the  above stages.  But  users
  772.       are expecting color mapped images as decoded results. ImgFun uses
  773.       the  tagged  palette  to   map   each  pixel  into  the  palette.
  774.       According  to experience,   this   process  of   remapping  takes
  775.       about  a third  to  more  than  half  of    the   total  decoding
  776.       process.  This is  why it's much  slower in  the    decompression
  777.       of    color      mapped images   than the compression.  Also  the
  778.       remapping process  loses information.  This  is the   price  paid
  779.       for  the  color  mapped display system.
  780.  
  781.           ImgFun only accepts JPEG images with Y,U,V 2:1:1 sub sampling
  782.       in horizontal and  vertical   directions  with  one   interleaved
  783.       scan.   A  non-interleaved     format    stores    the  luminance
  784.       and   chrominance  components   separately.    This   makes    it
  785.       impossible for  a    fast  efficient  one  pass decoding  process
  786.       without  huge amount of memory (bytes  needed  :three  times  the
  787.       width   times  the height of the image).   Thus these images  are
  788.       not  supported.  Although,  JPEG document  does  not specify  the
  789.       color  space,  the Y,  U,  V space  is  becoming    the standard.
  790.       For JPEG    images  without    palette   information,   a uniform
  791.       palette  is used for decompressing the  JPEG image  into a  color
  792.       mapped   image.   The result may not  be satisfied.  This problem
  793.       is left  in  the next  version. The major  drawback   of  JPEG is
  794.       that   the decoded result is a  true color   image  which is hard
  795.       to appreciate  in the   PC world.  ImgFun attacks this problem by
  796.       tagging  the  palette  and remapping the true  color image into a
  797.       color mapped image in the decoding process.
  798.  
  799.           For  a  color  mapped  GIF image,  the JPEG  compressed image
  800.       usually  have  a  compression   ratio  3  to  10  depending  upon
  801.  
  802.  
  803.  
  804. ImgFun.txt               Speedy Software                   page 16
  805.  
  806.  
  807.       compression level specified.
  808.  
  809.           For a  gray level GIF  image,  a compression ratio  above  10
  810.       can be  achieved  without much visual  distortion. ImgFun  offers
  811.       the function  to view compressed JPEG   images  without  decoding
  812.       into disk  files.  This  will help  a   lot when   viewing   JPEG
  813.       images stored  in a  floppy  disk,  especially   for  gray  level
  814.       images which are decoded quite fast under ImgFun.
  815.  
  816.         ImgFun reads  in   base  line  JPEG   files complying with  the
  817.       revision 8 and revision 9 drafts  with   restrictions   mentioned
  818.       and always writes out  JPEG images that comply with the  revision
  819.       9  except that an application  tag  is  used  for the palette and
  820.       some  private  information  which  should  be  ignored  by  other
  821.       software.
  822.  
  823.         Users are  recommended   to store   final images  (images don't
  824.       need processing  any  more  and  are  used  mainly   for  viewing
  825.       and printing  from  the  archive)  by JPEG compression for saving
  826.       the disk space.
  827.  
  828.       7.5  Other Formats
  829.  
  830.           Support  for other  formats  is  under  consideration for the
  831.       future  versions  of   ImgFun.   Please  inform   the  author for
  832.       supporting formats   desired.  Since    this  is a user-supported
  833.       program, features desired from  the  feed back   of   users  will
  834.       be  added,   too.   Also   a   lossless compression   scheme  for
  835.       256  color  mapped images  is   under development. The   goal  is
  836.       to  compress  GIF images to 60%  of the original size losslessly.
  837.  
  838.  
  839.  
  840.  
  841.  
  842. ImgFun.txt               Speedy Software                   page 17
  843.  
  844.  
  845.  
  846.  
  847.                                 8.  Function Usage:
  848.  
  849.       8.1  File:
  850.  
  851.       8.1.1  Load: Load an image to work.
  852.       8.1.2  View: View an image file.
  853.       8.1.3  Save: Save the loaded image 1.
  854.       8.1.4  Quit: Quit ImgFun.
  855.  
  856.       8.2  Adjust:
  857.  
  858.       8.2.1  Brighten: Brighten the loaded image.
  859.       8.2.2  Darken  : Darken the loaded image.
  860.       8.2.3  Contrast:
  861.                     Adjust  contrast  by   gray   level   remapping  of
  862.                     the palette of the loaded image 1.
  863.  
  864.       8.2.4  cOlor   :
  865.                     Adjust the colors  in the palette  of  the palette
  866.                     of the loaded image 1.
  867.                     Two functions, RGB and PSEUDO are implemented.
  868.                     Please use the  on-line  help  system  to  get more
  869.                     information.
  870.  
  871.  
  872.       8.3  Set:
  873.  
  874.       8.3.1  Background: Choose a background color.
  875.       8.3.2  Cut area  :
  876.                       Set a cut area of the loaded image 1.
  877.       8.3.3  Directions:
  878.                       Set  horizontal  and  vertical   directions
  879.                       of the  loaded image 1.
  880.       8.3.4  Threshold : View a binary map
  881.                       from  the  loaded  image 1 for a given  threshold
  882.                       on the gray level.
  883.  
  884.       8.4  Transform:
  885.  
  886.       8.4.1  Rescale   :
  887.  
  888.            Rescale loaded   image  1    to   a    different   width  or
  889.       height.  The new height  and  new  width should be 25%  to   400%
  890.       of  the  old values  and   not exceeding  the  system limit.  For
  891.       images  with  16 colors or fewer, only zero   order interpolation
  892.       is  used.   For images with more  colors and the   new  values of
  893.       heights  and  widths  are    within     150%    of     the    old
  894.       values,     zero-order interpolation  is used.  For others  first
  895.       order  interpolation is used. The result  is  remapped  into  the
  896.       palette.
  897.  
  898.  
  899.  
  900. ImgFun.txt               Speedy Software                   page 18
  901.  
  902.  
  903.  
  904.       8.4.2  Smooth:
  905.            Smooth the loaded image 1 in the luminance component.
  906.  
  907.       8.4.3  shArpen:
  908.            Sharpen  the loaded image 1 in the luminance component.
  909.  
  910.  
  911.          These   three  functions treat the  loaded  image  1    as   a
  912.       true color image.  After  processing  the  image,  ImgFun remapps
  913.       the internal true color into the original palette.
  914.  
  915.       8.4.4  rOtate:
  916.                   Rotate the loaded image 1 by 90, 180, or 270 degrees.
  917.  
  918.  
  919.       8.5  Options:
  920.  
  921.       8.5.1  Display  :
  922.                     Set the display mode  and the   starting display
  923.                     point (xmin ,ymin) in the  screen.
  924.       8.5.2  card     :
  925.                     This  function  is  a  new add-on in ver.  1.0.  It
  926.                     allows the user to manual select the SVGA driver.
  927.  
  928.       8.5.3  direcTory:
  929.                     IMAGE: Specify where image files  are located.
  930.                     HELP : Specify where  ImgFun.hlp resides.
  931.  
  932.       8.5.4  Dither   :
  933.                     ON  or OFF. Use dithering or  not  when remapping
  934.                     internal true color images into a palette.
  935.  
  936.       8.6  Utility:
  937.  
  938.       8.6.1  Compress  : JPEG compression
  939.  
  940.       8.6.2  cOnvert   :
  941.                       Do conversion  between   different  formats, also
  942.                       decompression of JPEG images
  943.  
  944.       8.6.3  sLide show: a manual slide show
  945.  
  946.       8.7  Undo and Update:
  947.  
  948.         Undo  (F2): Remove all the changes made since last update.
  949.  
  950.         Update(F4): Accept the current image  and makes  changes since
  951.                     the last update permanent on the loaded image 1.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958. ImgFun.txt               Speedy Software                   page 19
  959.  
  960.  
  961.       8.8  Swap (F3) :
  962.                      Swap the loaded image 1 and the loaded image 2.
  963.  
  964.       8.9  DOS  (F6) :Shell out to DOS.
  965.  
  966.       8.10  Gray (F7) :
  967.                      Turn the loaded image 1 into a gray level image.
  968.  
  969.       The on line help system has more details about these functions.
  970.  
  971.  
  972.  
  973.  
  974.  
  975. ImgFun.txt               Speedy Software                   page 20
  976.  
  977.  
  978.  
  979.       Author:
  980.  
  981.         Here I have to say some special thanks to some people.
  982.  
  983.       Dr. Lane and the JPEG independent group: Some of the work  in the
  984.       JPEG  part is based  on JPEG  Independent   Group's   work.  I do
  985.       appreciate their efforts in promoting the standard JPEG  format.
  986.  
  987.       Haruyasu Yoshizaka,  the author  of the LHA package, and  Fabrice
  988.       Bellard, the  author  of  the  LZEXE  package : Their packages do
  989.       provide a lot convenience for lossless data compression in the pc
  990.       platform.
  991.  
  992.       Steve  Estvanik,  ASP  Author  Membership  Coordinator:  For  his
  993.       patience  in  the  reviewing process and comments on  the  ImgFun
  994.       package.
  995.  
  996.       <Ver. 0.99>
  997.  
  998.           The program  is  written    carefully   to    be  really lean
  999.       and fast  under   DOS.
  1000.  
  1001.       Hope you will enjoy the result.
  1002.                                                   Thanks!       9/15/92
  1003.       <Ver. 1.00>
  1004.           This version adds in  a manual  configure function   for  the
  1005.       SVGA display driver  and  a  new  function,  PSEUDO in the Adjust
  1006.       Color selection. The true color  compression is left in  a  major
  1007.       upgrade in 1993. But stand alone programs for compressing  24 bit
  1008.       BMP and PCX images might  be available in early 1993 in the bonus
  1009.       package for registered users.  Please  register  to  support this
  1010.       program and let  you have the  rights to obtain the latest  bonus
  1011.       utilities in the ImgFun package.
  1012.                                                    Thanks!      12/4/92
  1013.  
  1014.       Chin-Chi ,Hsu at Speedy Software
  1015.  
  1016.       author member of Association of Shareware Professionals
  1017.  
  1018.       173 Franklin Ave.  San Gabriel, CA 91775
  1019.  
  1020.       CompuServe ID : 71551,3641 (best way to contact me)
  1021.  
  1022.       TEL: 818-282-8018
  1023.  
  1024.       PS. All trademarks mentioned belong to the proper owners.
  1025.  
  1026.